Inside Macintosh: QuickDraw GX Graphics /

Chapter 4 - Geometric Operations / Geometric Operations Reference

Functions / Performing Geometric Arithmetic With Shapes

GXUnionShape

You can use the GXUnionShape function to find the union of two shapes.

void GXUnionShape(gxShape target, gxShape operand);

target

On input, a reference to one of the shapes to combine. On output, a reference to the union of the input target shape and the operand shape.

operand

A reference to the other shape to combine.

DESCRIPTION

The GXUnionShape function finds the union of the target shape and the operand shape, reduces and simplifies the result, and stores it in the target shape.

This function considers the shape fill, the style modifications, and the transform mapping of the target and operand shape. Only areas that are drawn are considered when calculating the union.

The target shape and the operand shape must both have solid fills (even-odd, winding, inverse even-odd, or inverse winding) or both have framed fills (open-frame or closed-frame); one of each type of fill is not allowed.

If you provide a target or operand shape that is not one of the geometric shape types, this function performs the actions described in the following table:

Shape type	Action taken
bitmap	Posts the error shape_operator_may_not_be_a_bitmap
picture	Posts the error shape_operator_may_not_be_a_picture
text	Converts to path shape if other parameter is not an empty shape or a full shape
glyph	Converts to path shape if other parameter is not an empty shape or a full shape
layout	Converts to path shape if other parameter is not an empty shape or a full shape

ERRORS, WARNINGS, AND NOTICES

Errors
out_of_memory
shape_is_nil
number_of_contours_exceeds_implementation_limit
number_of_points_exceeds_implementation_limit
size_of_path_exceeds_implementation_limit
size_of_polygon_exceeds_implementation_limit
fill_type_not_allowed	(debugging version)
shape_access_not_allowed	(debugging version)
clip_to_frame_shape_unimplemented	(debugging version)
shape_operator_may_not_be_a_bitmap	(debugging version)
shape_operator_may_not_be_a_picture	(debugging version)
Warnings
character_substitution_took_place
font_substitution_took_place
unable_to_traverse_open_contour_that_starts_or_ends_off_the_curve
	(debugging version)

SEE ALSO

For examples using this function, see "Performing Geometric Arithmetic With Shapes" beginning on page 4-60.

For a discussion of geometric arithmetic, see "Geometric Arithmetic" beginning on page 4-21.

For a discussion of shape fills, see Chapter 2, "Geometric Shapes," in this book.

For a discussion of style modifications, see Chapter 3, "Geometric Styles," in this book.

For a discussion of transform mappings, see Inside Macintosh: QuickDraw GX Objects.

To find the intersection of two shapes, use the GXIntersectShape function, described on page 4-107.

Main | Page One | What's New | Apple Computer, Inc. | Find It | Contact Us | Help